home *** CD-ROM | disk | FTP | other *** search
/ PC World Komputer 2003 November A / PCWK1103A.iso / Adobe After Effects 6.0 tryout / MM6.Cab / F8501_readme.txt.CBB56670_278B_11D4_8520_00C04F602FD3 < prev    next >
Text File  |  2003-07-18  |  6KB  |  156 lines
  1. HelixÖ Producer 9.0 SDK from RealNetworks«
  2.  
  3. Information in this SDK is subject to change without notice. Companies,
  4. names, and data used in examples herein are fictitious unless otherwise
  5. noted. No part of this document may be reproduced or transmitted in any
  6. form or by any means, electronic or otherwise, for any purpose, without the
  7. express written permission of RealNetworks, Inc.
  8.  
  9. This SDK is licensed under the terms of the license agreement found in
  10. license.txt.
  11.  
  12. New Features
  13.  
  14.    * Support for file and capture input (8.5x version of the SDK did not
  15.      support this)
  16.    * Job files, audience files, server settings files - support for
  17.      serialization and deserialization of settings files
  18.    * New plug-in architecture for the encoding platform
  19.    * Fault-tolerant, independent outputs - allows uninterrupted live
  20.      archive to file when server connection is lost
  21.    * Multiple server and file destinations
  22.    * Improved multi-processor support for video encoding
  23.    * Any number of custom audiences
  24.    * Customizable duress streams in SureStream file (system no longer
  25.      forces automatic duress streams)
  26.    * New Remote Broadcast System
  27.    * Logging system
  28.    * RealMedia Edit API
  29.    * RealMedia Image Maps and Events support in Edit API
  30.    * Output filter plug-in support
  31.    * Post-encode filter plug-in support
  32.  
  33. Platform Requirements
  34.  
  35. This release of the SDK is only supported on the following platforms:
  36.  
  37.    * Windows 98SE, ME, NT 4.0, 2000, XP
  38.    * Linux 2.2 kernel, libc6
  39.  
  40. To compile the sample applications on Windows, Microsoft Visual C++ 6.0 or
  41. later is required. To compile the sample applications on Linux, the gcc
  42. 2.95.2 compiler is required.
  43.  
  44. Sample Applications
  45.  
  46. This SDK comes with sample applications located in a subdirectory called
  47. "samples". These are described below.
  48.  
  49. encoder
  50.  
  51. An example encoder application that demonstrates basic encoding. The
  52. interfaces used in this sample are ideal if you want to encode from an
  53. existing audio/video file or a/v capture device. This sample also provides
  54. an example of how to write a log observer.
  55.  
  56. mediasinkencoder
  57.  
  58. An example application that uses input pin interfaces to provide raw
  59. audio/video data to the encoding engine. This is the method of encoding
  60. that is most similar to the previous SDK. If your application already deals
  61. with audio/video data directly, you will want to use the SDK in this way.
  62.  
  63. inputplugin
  64.  
  65. An example that demonstrates how to build a file reader input plug-in for
  66. the encoding engine.
  67.  
  68. To test your plug-in:
  69.  
  70.   1. Copy the dll you have built, InWAVPlugin.dll (Windows) or
  71.      InWAVPlugin.so.0.1 (Linux) into the bin\tools subdirectory of the SDK
  72.      installation directory
  73.   2. Temporarily remove the existing WAV reader plug-in (riwv3290.dll on
  74.      Windows, RSInWAVPlugin.so.9.0 on Linux) from the bin\tools directory
  75.   3. Run an encoding job using a .wav file for input
  76.  
  77. prefilterplugin
  78.  
  79. An example that demonstrates how to build a media pre-filter plug-in for
  80. the encoding engine.
  81.  
  82. To test your plug-in:
  83.  
  84.   1. Copy the DLL you built, PrefilterExamplePlugin.dll (Windows) or
  85.      PrefilterExamplePlugin.so.0.1 (Linux), into the \tools subdirectory of
  86.      the Helix Producer installation directory.
  87.   2. Create a job file using either the Helix Producer GUI application or
  88.      command line application with the -cj switch.
  89.   3. Open the job file in a text editor and add the following information
  90.      about the sample prefilter under the prefilters tag:
  91.  
  92.      <prefilters>
  93.        <examplePrefilter>
  94.          <enabled type="bool">true</enabled>
  95.          <pluginName type="string">rn-prefilter-example</pluginName>
  96.        </examplePrefilter>
  97.      </prefilters>
  98.  
  99.   4. Open/run the job from the Helix Producer with logging diagnostics
  100.      turned on. Looking at the log after an enocde, you will see a Video
  101.      Pre-filter Diagnostic message "Prime method called on
  102.      rn-prefilter-example" which shows that the example prefilter is being
  103.      called.
  104.  
  105.  
  106.  
  107. Troubleshooting
  108.  
  109. This section describes troubleshooting tips related specifically to the
  110. SDK.  See the application readme.txt for troubleshooting tips related to
  111. the application or any of its plug-ins such as file reader, capture input
  112. or output plug-ins.
  113.  
  114. General
  115.  
  116.   1. Change If you are compiling the sample application, 'encoder', and you
  117.      get the error "kValuePluginTypePrefilterAudioLimiter is an undefined
  118.      identifier" make the following changes:
  119.  
  120.      Add the following constants:
  121.       static const char kValuePluginNamePrefilterAudioGain[]
  122.      ="rn-prefilter-audiogain"; /* string */
  123.       static const char kValuePluginTypePrefilterAudioGain[]
  124.      ="audioGainPrefilter"; /* string */
  125.  
  126.      And the corrected chunk of code in CEncoderApp::SetupPrefilters() to
  127.      look like:
  128.  
  129.       // Set plugin type
  130.       if (SUCCEEDED(res))
  131.       res =pInitParams->SetString(kPropPluginType,
  132.      kValuePluginTypePrefilterAudioGain);
  133.  
  134.       // Set plugin name. Note that plugin name is typically specified when
  135.      creating prefilters -- this
  136.       // is different than the code to create inputs (plugin name wasn't
  137.      specified then). This is because
  138.       // there were several input readers that the Helix Producer SDK
  139.      selected from, while there is only a single
  140.       // prefilter that matches the black level prefilter plugin type.
  141.       if (SUCCEEDED(res))
  142.       res = pInitParams->SetString(kPropPluginName,
  143.      kValuePluginNamePrefilterAudioGain);
  144.  
  145.   2. An application using the SDK could get a SIGPIPE signal on Linux in
  146.      case of an error in TCP broadcast to server. (e.g. network error or
  147.      server goes down).  An application using the SDK application should
  148.      either handle SIGPIPE signal or ignore it.  Refer to the advanced
  149.      encoder sample for a way of ignoring this signal.
  150.  
  151. Copyright ⌐ 2002 RealNetworks, Inc. Helix, RealAudio, RealNetworks,
  152. RealPlayer, RealOne Player, RealSystem, RealVideo, and SureStream are
  153. trademarks or registered trademarks of RealNetworks, Inc. All other
  154. companies or products listed herein are trademarks or registered trademarks
  155. of their respective owners. All rights reserved.
  156.